home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 001 / pibt3ep2.arc / README.DOC < prev    next >
Text File  |  1985-10-08  |  7KB  |  225 lines
  1. INTRODUCTION TO PIBTERM v3.0
  2. ============================
  3.  
  4. These archive files PIBT3EP1.ARC and PIBT3EP2.ARC contain a
  5. program called PibTerm which provides a terminal emulation
  6. and host communications facility.
  7.  
  8. This is version 3.0 of Pibterm, released October 7, 1985.
  9.  
  10. Features of PibTerm version 3.0 include:
  11.  
  12.    1.  Several different terminal emulation methods:
  13.  
  14.           -- DEC VT52
  15.           -- DEC VT100 (large subset)
  16.           -- BBS ANSI  (ANSI.SYS color graphics and music)
  17.           -- Dumb glass TTY
  18.           -- Dumb glass TTY in split-screen mode
  19.  
  20.    2.  The ability to act as a host program (mini BBS).
  21.  
  22.    3.  Ring buffered, interrupt driven, serial I/O.
  23.  
  24.    4.  A number of popular file transfer methods:
  25.  
  26.           -- Xmodem Checksum and CRC
  27.           -- Modem7 batch with either Checksum or Crc
  28.           -- Ymodem batch or single file
  29.           -- Telink
  30.           -- Kermit
  31.           -- CompuServe "B" Protocol
  32.           -- Ascii with XON/XOFF
  33.           -- Autodownload Xmodem for Bob Mahoney's EXEC PC BBS.
  34.  
  35.    5.  Telephone dialing directory.
  36.  
  37.    6.  Session logging/capture to printer and/or disk.
  38.  
  39.    7.  On-screen editing (block mode) for use with mainframes.
  40.  
  41.    8.  Menu-driven commands.
  42.  
  43.    9.  Macro-key definition, with sufficient capability to
  44.        provide auto-logon scripts.
  45.  
  46.   10.  Escapes to the operating system (and return from DOS)
  47.        within a PibTerm session.
  48.  
  49.   11.  Built-in file and directory manipulation, including
  50.        directory display, file display, file copying, file erasure.
  51.  
  52.   12.  Screen dumps to a file.
  53.  
  54.   13.  Customizable modem support.
  55.  
  56.   14.  Automatic change of baud rate to the proper one with
  57.        smart modems like the Hayes 1200 and USR Courier.
  58.  
  59.   15.  Built-in phone area code directory.
  60.  
  61.   16.  Review buffer for lines scrolled off top of screen.
  62.  
  63.   17.  Easy alteration of program parameters to customize to
  64.        a particular system.
  65.  
  66.   18.  Extensive script facility for automating communications chores.
  67.  
  68. Version 3 also fixes a number of problems from earlier versions
  69. of PibTerm.
  70.  
  71. These archive libraries were created using ARC430.EXE.  I assume that if you
  72. are reading this file, then you have the proper version of ARC!
  73.  
  74.  
  75. CONTENTS
  76. ========
  77.  
  78. Archive file PIBT3EP1.ARC
  79. -------------------------
  80.  
  81. This archive should contain 4 files, as follows:
  82.  
  83.      PIBTERM.COM   (Executable files and overlays for PibTerm)
  84.      PIBTERM.000
  85.      PIBTERM.001
  86.      PIBTERM.002
  87.  
  88. Archive file PIBT3EP2.ARC
  89. -------------------------
  90.  
  91. This archive should contain 13 files, as follows:
  92.  
  93.      PIBTERM.003   (More PibTerm overlays)
  94.      PIBTERM.004
  95.      PIBTERM.005
  96.      PIBTERM.006
  97.      PIBTERM.007
  98.  
  99.      PIBTERM.FON   (Sample dialing directory)
  100.      PIBTERM.PRE   (Empty dialing prefix file)
  101.      PIBBW.CNF     (Configuration for monochrome monitor)
  102.      PIBCOLOR.CNF  (Configuration for color monitor)
  103.  
  104.      VT100.FNC     (Key definitions for VT100 keypad keys)
  105.      CDCNOS.FNC    (Key definitions for VT100 under CDC NOS)
  106.  
  107.      PIBTERM3.DOC  (Printable documentation for PibTerm)
  108.      README.DOC    (What you're reading now)
  109.  
  110.  
  111. CHECKING ARCHIVE'S INTEGRITY
  112. ============================
  113.  
  114. After downloading PIBT3EP1.ARC and PIBT3EP2.ARC, it's a good idea to
  115. verify the integrity of those files using the integrity check
  116. feature of ARC430.  To perform the check, enter:
  117.  
  118.      ARC430 T PIBT3EP1.ARC
  119.      ARC430 T PIBT3EP2.ARC
  120.  
  121. If the archives pass the integrity check, then you can proceed
  122. to extract the files as shown below.  If an archive is bad, you
  123. can either try downloading it again (although the file may be
  124. bad on the BBS you called), or write me for the source + executables
  125. disks as described below.
  126.  
  127.  
  128. DOCUMENTATION
  129. =============
  130.  
  131. Full documentation for PibTerm is found in file PIBTERM3.DOC in
  132. PIBT3EP2.ARC.
  133.  
  134.  
  135. USING PIBTERM
  136. =============
  137.  
  138. To execute PibTerm, extract the files all files from the archive
  139. files using the commands:
  140.  
  141.    ARC430 E PIBT3EP1.ARC *.*
  142.    ARC430 E PIBT3EP2.ARC *.*
  143.  
  144. Make sure all the files reside in the same directory.
  145. If you have a color monitor and color graphics card, rename the
  146. file PIBCOLOR.CNF to PIBTERM.CNF.  If you have a monochrome
  147. monitor, rename the file PIBBW.CNF to PIBTERM.CNF.
  148.  
  149. Enter PIBTERM in response to the DOS prompt, and away you go!
  150.  
  151. To find out how to execute PibTerm from a different directory,
  152. see pages 6 and 7 of the documentation file PIBTERM3.DOC.
  153.  
  154.  
  155. SOURCE CODE FOR PIBTERM
  156. =======================
  157.  
  158. The source code for Pibterm comprises about 34000+ lines of Turbo
  159. Pascal.  You may be able to find the source archive files PIBT3SP1.ARC
  160. through PIBT3SP4.ARC on the same BBS from which you obtained this executable
  161. version.  If not, then you may get the source by sending $12 to:
  162.  
  163.               Philip R. Burns
  164.               Vogelback Computing Center
  165.               Northwestern University
  166.               2129 Sheridan Road
  167.               Evanston, IL.  60201
  168.  
  169. The $12 is a media, mailing, and handling cost, not a program charge.
  170. You will receive two disks with the complete source in ARC version 4.3
  171. format, as well as the corresponding executables.
  172.  
  173.  
  174. RESTRICTIONS ON USE
  175. ===================
  176.  
  177. You may also make unlimited copies of the program and distribute these
  178. copies as you desire, except that I, Philip R. Burns, reserve the sole right
  179. to distribute the program for profit.  You may request a duplication
  180. charge, not to exceed $10 per copy for the complete executables archive.
  181.  
  182. You should distribute the program without any changes you have made,
  183. and then a SEPARATE version with any changes you've made.
  184. You should clearly mark the changes in some sort of documentation file,
  185. as well as in the source files you change.  I also suggest that you
  186. add a line to the initial output of PibTerm indicating your name and
  187. the date of your modification.
  188.  
  189. You may use the source code and modify it as you please for
  190. NON-COMMERCIAL APPLICATIONS ONLY.  You may NOT use the code in
  191. developing commercial applications without my permission.
  192.  
  193. I encourage you to extend this program and add interesting
  194. new features.  I also encourage you to upload these changes to
  195. your local BBSs in order to share your work with others.  What I
  196. do NOT want is for you to rip off this code as if it were yours
  197. and sell it for a profit.  That's not nice.
  198.  
  199. THE GD= PARAMETER
  200. =================
  201.  
  202. I left out one important piece of information in the documentation.
  203. The configuration parameter GD= specifies the number of hours that
  204. local time lags Greenwich mean time.  This information is used to
  205. adjust the universal time dates received during Ymodem transfers.
  206. For example, Chicago generally lags Greenwich mean time by six hours.
  207. You will need to change this parameter in the file PIBTERM.CNF
  208. using a text editor, since I forgot to allow a menu item for it.
  209.  
  210. ADDRESSES FOR ELECTRONIC LETTER BOMBS
  211. =====================================
  212.  
  213. You may leave me messages on the following BBSs:
  214.  
  215.       Gene Plantz's BBS (312) 882 4145
  216.       Ron Fox's BBS     (312) 940 6496
  217.  
  218. Gene's board is registration only ($15 a year) but well worth it.
  219. Ron's board is essentially open, and also worth calling.
  220.  
  221. Thanks,
  222. Phil Burns
  223. October, 1985
  224.  
  225.